perf(am): 봉인 조회가 매 append 마다 원장 전체를 파싱했다 — 꼬리만 읽는다 - #4

바로 앞 커밋의 후속이자 그 커밋이 만든 결함의 수리다. [거울/트리아지] 가 등급 심사에서
*"디프가 파일 I/O·인코딩인데 이 레포는 Windows CI 가 0"* 이라고 짚었고, 그 자리를 실제로
재 보니 결함이 있었다.

## 무엇이 깨졌나

바이트로 읽기 시작하면서 **텍스트 모드의 유니버설 개행 번역을 잃었다.** `\n` 으로만 잘라서
`\r` 단독 개행 원장이 **한 줄**로 파싱됐고, 조회가 `GENESIS` 를 답했다.

그 답으로 append 하면 **살아 있는 체인 한가운데에 두 번째 genesis 항목**을 쓴다.
이 도구에서 낼 수 있는 최악의 실패다 — 조용하고, 체인을 가른다.

```
CR 단독 개행 · 3항목 원장
  수리 전(텍스트 모드)  → cccccccc…   (마지막 봉인)
  꼬리 읽기 첫 판       → GENESIS     🔴
  이번 수리 후          → cccccccc…   ✅
```

## 수리

버퍼를 자르기 전에 `\r\n` · `\r` 을 `\n` 으로 정규화한다. JSON 문자열 안의 날 CR/LF 은
애초에 유효한 JSON 이 아니므로(제어문자는 `\r` 두 글자로 이스케이프된다) 안전하다.
CRLF · CR · LF · 섞인 것 넷 다 텍스트 모드 판과 같은 답을 낸다.

## 못 보던 자리를 계기에 넣는다

- 동치 시험 케이스에 **CRLF · CR 단독 · 섞인 개행** 3종 추가(12 → 15). 대조군(`\n` 만 자르는
  판)에 걸면 실패한다.
- 케이스 파일을 `newline=""` 로 쓴다 — 안 그러면 **Windows 가 모든 `\n` 을 `\r\n` 으로 조용히
  바꿔서**, 개행을 시험한다고 이름 붙인 케이스가 개행을 시험하지 않게 된다.
- 🔴 **CI 매트릭스에 `windows-latest` 를 넣는다**(잡 3 → 6). 이 패키지는 원장 파일을 읽고 쓴다.
  리눅스 전용 매트릭스로는 위 결함을 **원리적으로 볼 수 없었다.** 변조증거 도구가 못 보는
  운영체제를 가지고 있을 수는 없다.

tests 53/53.

Co-authored-by: Mother Seara <seara@bhyi4.com>
Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>

앞 커밋의 수리가 **자식의 인코드 실패를 부모의 디코드 실패로 옮겼을 뿐**이었다.
Windows 잡이 7 fail → 1 fail 로 줄고 그 하나가 남은 이유다.

## 무엇이 남아 있었나

`_printable_streams()` 가 stdout 을 **UTF-8 로 재구성**했다. 그러자 자식은 UTF-8 바이트를
쓰는데, 그걸 읽는 Windows 호출자는 파이프를 **로케일 인코딩(cp1252)** 으로 디코드한다.
리더 스레드가 `byte 0x81`(증인 줄의 👁 = `F0 9F 91 81`)에서 `UnicodeDecodeError` 로 죽고
`r.stdout` 이 **None** 으로 돌아온다.

```
tests/test_cli_exit_codes.py::test_verify_peer_rewrite_exits_1
>   assert "FAIL" in r.stdout and r.returncode == 1
E   TypeError: argument of type 'NoneType' is not iterable
```

🔴 **리눅스에서 그대로 재현했다**(자식 `PYTHONIOENCODING=cp1252` · 부모 `encoding="cp1252"`).
같은 `byte 0x81` 이다. 윈도우는 리더가 별도 스레드라 예외가 `stdout=None` 으로 나타날 뿐이다.

## 수리

**인코딩은 건드리지 않고 `errors="replace"` 만 건다.** 출력을 읽는 쪽은 이미 그 콘솔의
인코딩을 알고 있다 — 그들이 못 견디는 건 코덱 예외지 `?` 가 아니다. 판정 글자는 ASCII 라
어느 쪽이든 온전히 통과한다.

## 시험 (57/57 · 신규 1 · 기존 3 정정)

신규: **자식이 선언한 것과 같은 코덱으로 부모가 파이프를 읽는다** — Windows 하네스를
아무 플랫폼에서나 재현한다. 앞서 쓴 3건도 `read_as="cp1252"` 로 맞췄다(자기가 지정한
인코딩으로 읽는 게 계약이다).

대조군 **둘 다** 잡는다:
· 수리 없음 → 4건 실패(원래 크래시)
· **옛 수리(UTF-8 강제) → 1건 실패** ← 내가 방금 낼 뻔한 회귀가 정확히 이 시험에 걸린다

Co-authored-by: Mother Seara <seara@bhyi4.com>
Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>

앞 두 커밋이 `_cli()` 안에서만 콘솔을 고쳤다. `examples/demo_family.py` 는 **그 진입점을
안 지나고 같은 이모지를 직접 찍는다** — 그래서 시험이 57/57 초록인 동안에도 cp1252 에서
계속 죽었다. CI 는 `Run tests` 가 아니라 **`Dogfood` 스텝**에서 빨갛다.

🔴 **이번 왕복의 모양은 인코딩이 아니라 분모다.**
`57/57` 은 **pytest 분모**고, CI 초록의 분모는 `pytest` + `Dogfood` + `package` 다.
나는 앞의 하나를 전체로 보고했다. [거울/트리아지] 가 그 자리를 짚었다.

## 수리
예제 상단에서 `am._printable_streams()` 를 부른다(사설 import 는 의도적이다 — 이 패키지
자신의 예제이고 그 헬퍼는 공개 API 가 아니다).

★ **예제는 새 사용자가 처음 실행하는 코드**다. 여기서 죽는 건 시험에서 죽는 것보다 나쁘고,
이건 이 PR 과 무관하게 **원래 그랬다** — 볼 수 있는 러너가 없었을 뿐이다.

## 계기
`Dogfood` 스텝을 **pytest 안으로** 끌어온다: cp1252 콘솔로 예제를 실행해 exit 0 을 확인한다.
한 러너의 한 스텝에만 있는 가드는 **대부분의 실행이 안 밟는다**. 이제 리눅스 pytest 가 잡는다.
(설치된 휠 실행처럼 `examples/` 가 없는 배치에선 skip 한다.)

대조군: 예제에서 그 한 줄을 빼면 새 시험이 **실패한다.**

tests 58/58.

Co-authored-by: Mother Seara <seara@bhyi4.com>
Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>